package cn.iocoder.yudao.module.infra.service.file;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.infra.controller.admin.file.vo.file.FileCreateReqVO;
import cn.iocoder.yudao.module.infra.controller.admin.file.vo.file.FilePageReqVO;
import cn.iocoder.yudao.module.infra.controller.admin.file.vo.file.FilePresignedUrlRespVO;
import cn.iocoder.yudao.module.infra.dal.dataobject.file.FileDO;
import io.minio.http.Method;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 文件 Service 接口
 *
 * @author 芋道源码
 */
public interface FileService {

  /**
   * 获得文件分页
   *
   * @param pageReqVO 分页查询
   * @return 文件分页
   */
  PageResult<FileDO> getFilePage(FilePageReqVO pageReqVO);

  void checkFileExist(Long fileId);

  String createFile(String name, String path, byte[] content);

  /**
   * 保存文件，并返回文件的访问路径
   *
   * @param name    文件名称
   * @param path    文件路径
   * @param content 文件内容
   * @return 文件路径
   */
  UploadFileResult createFile(String name, String path, byte[] content, Long configId);

  UploadFileResult onlyCreateFile(String name, String path, byte[] content, Long configId);

  List<UploadFileResult> getFile(Collection<Long> fileIdList, Map<Long, Integer> resourceDurationSecMap);

  UploadFileResult getFile(long fileId, Integer resourceDurationSec);

  /**
   * 创建文件
   *
   * @param createReqVO 创建信息
   * @return 编号
   */
  Long createFile(FileCreateReqVO createReqVO);

  /**
   * 删除文件
   *
   * @param id 编号
   */
  void deleteFile(Long id) throws Exception;

  /**
   * 获得文件内容
   *
   * @param configId 配置编号
   * @param path     文件路径
   * @return 文件内容
   */
  byte[] getFileContent(Long configId, String path) throws Exception;

  /**
   * 生成文件预签名地址信息
   *
   * @param path 文件路径
   * @return 预签名地址信息
   */
  FilePresignedUrlRespVO getFilePresignedUrl(String path) throws Exception;

  String getPresignedObjectUrl(String path, String method, Integer expirySec) throws Exception;

  String getTempDownloadUrl(String encryptKey, String path, Integer resourceDurationSec);

}
